home *** CD-ROM | disk | FTP | other *** search
/ Risc World 3 / Risc World 3.iso / SOFTWARE / ISSUE2 / CDWRITING / FRONTEND / !AMPlayer / !Help < prev    next >
Text File  |  2001-10-15  |  6KB  |  165 lines
  1.  
  2.                                  AMPlayer
  3.                                  --------
  4.  
  5.  
  6. This is a module for playing Audio MPEG files through the computer sound
  7. output. It will select the 8 or 16 bit output depending on the normal
  8. configuration (and availability).
  9.  
  10. The frontend, !AMPlayer, doesn't do much in itself, apart from providing an
  11. interface to the module from the desktop.
  12.  
  13. The module has been designed so it is easy to make other frontends, or add
  14. support for the module to existing player-frontends.
  15.  
  16.  
  17. !AMPlayer frontend
  18. ==================
  19.  
  20. The frontend is mainly included as an example of how to make your own.
  21. It consists of a display and control part. There is no link between these
  22. two parts (with one exception: Counter mode). It might as well be two
  23. separate programs. The control part simply issues commands and SWIs to the
  24. player module. The display part presents the current state of the module.
  25. This means that any commands issued by something else (e.g. you) will also
  26. cause the display to react in exactly the same way, as if the operation had
  27. been performed using the controls.
  28.  
  29.  
  30. Control
  31. -------
  32.  
  33. The frontend is very simple, and behaves more or less like a normal tape deck.
  34. Dragging an AMPEG file to the window (or double-clicking on one) will ask the
  35. module to play it. The buttons below the display behaves like one would
  36. expect:
  37.  
  38. "Stop" will stop the playback.
  39.  
  40. "Play" is used to continue after pausing.
  41.  
  42. "Pause" stops playback, with the option of continuing from that point.
  43.  
  44. "Rewind" and "Fast forward" skips back and forth in the track. The sound
  45. quality while doing this may vary a lot, especially if the file is coming
  46. from a slow medium (e.g. a CD). Using these buttons while paused is preferable
  47. in these cases.
  48.  
  49. "Counter mode" toggles between display of elapsed, total, and remaining time.
  50. With some rare MPEG files (Variable bitrate and ID3v2 containing audio
  51. MPEGs), this may be inaccurate.
  52.  
  53. "Volume +/-" changes the overall volume. Some files will clip if this is set
  54. higher than -2 dB. If you suffer from clipping noise, lower it.
  55.  
  56. Another control function of !AMPlayer is, that if you hold shift while
  57. dragging in a file, it will be put on hold (and "QUEUE" will show). When the
  58. current file finishes, playback continues with the one dragged in. There
  59. can be only one file on queue at any time, so dragging in more files like this
  60. will just end up with the last one on hold. Some day this might change, who
  61. knows.
  62. Similarily, holding shift while clicking Stop, will only stop the current
  63. file, and continue with a queued one if any.
  64.  
  65. "Auto Queue": When playing a file, the directory is scanned, and the next
  66. file is automatically queued. If a directory is met, this is scanned too.
  67. When there are no more files in the directory, the scan is continued in the
  68. parent. When no file can be found, Auto Queue enters a "dormant" state (with
  69. the indicator flashing). If you play a new file in this state, the scan will
  70. be resumed from that file and onwards.
  71.  
  72. So, this scanning would take some time if there are lots of directories left,
  73. but no MPEG files at all. For this reason, it will skip a maximum of 30 files,
  74. then give up. At some point this limit will be user-defined.
  75. For various reasons, this scanning will not look for files of type AMPEG, but
  76. rather of the same type as was played last time. This is most useful on CDs,
  77. where the type-map isn't set up and the files are all reported as type Data.
  78.  
  79.  
  80. Display
  81. -------
  82.  
  83. Most of the display is fairly self-explanatory. The textual part can show
  84. various things:
  85. If the file contains a valid ID3 tag, the song title and artist are shown.
  86. If not, the leafname is shown. If an error occurs while decoding the stream,
  87. it will be displayed for a few seconds in place of the artist.
  88.  
  89.  
  90. AMPlayer module
  91. ===============
  92.  
  93. This is the program that does the actual work. There are various reasons for
  94. wanting to control the module directly instead of through the frontend:
  95. 1. You get better control, and can automate things using obey files, etc.
  96. 2. You may want to write your own frontend.
  97. 3. The fancy frontend uses memory and CPU time that might be better used
  98.    elsewhere.
  99.  
  100. For information on the module, consult the HTML manual supplied with
  101. AMPlayer.
  102.  
  103.  
  104. Credits
  105. =======
  106.  
  107. I have no documentation about the Audio MPEG format. So this module was
  108. produced by porting several other free MPEG decoders, extracting the
  109. necessary bits, then optimising it for RISC OS/ARM. The latter by rewriting
  110. the algorithms in most cases. Therefore, there are concepts and code bits
  111. by many different people left in this module. I will try to list the most
  112. obvious "contributors", as I could certainly not have done it without access
  113. to their work:
  114.  
  115. Michael Hipp & Oliver Fromme wrote mpg123, which was ported and used.
  116. Tomislav Uzelac wrote "amp", similarily ported and learned from.
  117. ISO MPEG Audio Subgroup Software Simulation Group, dist10 package was used
  118. as the main source of information about the intended functionality, rather
  119. than the actual implementation of it.
  120.  
  121. Special thanks to Gerph, who has been testing and suggesting for a long
  122. time, has made useful additional programs, and even wrote bits of this file
  123. when I didn't have time :-)
  124. His AMPlayer utilities (and many other useful programs) can be found at:
  125. http://www.movspclr.co.uk/
  126.  
  127. Many thanks to Robin Watts for taking up the task of providing various
  128. optimisations, and adding features which will appear in later versions of
  129. the module.
  130.  
  131. And thanks must go to the testers that put up with the early bugs
  132. (in order of appearance)...
  133. Kira, unCiscy, JanM, Zhadnost, Cocodude, MoZes, Lennier, Xargle, Ben,
  134. TwoFlower, Forrey & Nick, as well as all those on the beta testing
  135. mailing list.
  136.  
  137.  
  138. License
  139. =======
  140.  
  141. I don't speak Legalese, so if any lawyers have trouble understanding the
  142. following, please ask a grownup for help.
  143.  
  144. In its current form, this is free for copying and use by anyone, subject to
  145. the following:
  146. If you want to include any of this as part of a commercial product, you need
  147. my permission.
  148. It can be freely supplied with PD, Freeware, and similar programs, as long as
  149. proper credit is given, and no money is charged for them in any way.
  150.  
  151. At some point, I will include the source, and this licence will probably be
  152. replaced with the GPL, but that will not affect the status of previous
  153. versions.
  154.  
  155.  
  156. Contact
  157. =======
  158.  
  159. Questions, etc. should be addressed to:
  160. Thomas Olsson
  161. amplayer@armware.dk
  162.  
  163. New versions can be found at:
  164. http://www.armware.dk/files/
  165.